
             ┌────────────────────┐
             │   DOS-SHELL v1.5x  ├┐
             └┬───────────────────┘│
              └────────────────────┘

Программа DOS-SHELL предназначена для работы совместно  с  дис-
ковой операционной системой AO-DOS. Программа  дополняет  функ-
циональные возможности и значительно повышает  удобство  работы
с системой. Программа-оболочка DOS-SHELL требует для своей  ра-
боты 8 килобайт ОЗУ по  адресам  140000..157777  для  работы  с
БК0010(.01), в составе ДОС для БК0011(М) DOS-SHELL располагает-
ся в адресах 120000..137777 заданной страницы ОЗУ.

        Возможности DOS-SHELL
        ─────────────────────
- программа наглядно изображает содержание каталогов на дисках;
- удобно копирует, переименовывает, удаляет и запускает  файлы;
- позволяет  просматривать  и  рeдактировать  текстовые  файлы;
- выполнять любые команды ДОС;
- поддерживает работу с мышью;
- диалоговый режим аналогичен распространенной на IBM PC  прог-
  paмме Norton Commander.

        Начало работы с DOS-SHELL
        ─────────────────────────
После запуска  программы  в  верхней  части  экрана  появляются
два окна, ограниченных двойной рамкой  (панели).  Ниже  панелей
располагается обычное приглашение ДОС. Там можно вводить  обыч-
ные команды ДОС или имена файлов. Еще ниже располагается  стро-
ка, в которой указаны значения ключей (цифра 1..9,0 по  регист-
ру AР2). В одной из панелей находится  инверсная  полоса,  ука-
зывающая текущий файл :


      Left      Commands     Right      <заголовок подменю
┌───────A:\────────┐┌───────B:\────────┐   <имя текущего диска
│FILE1   │1000│2000││FILE1   │  │
│FILE2   │1000│3000││FILE2   │  │
│FILE3   │1000│ 123││FILE3   │  │
│FILE4   │1200│4000││FILE4   │  │
│FILE5   │1000│ 200││        │  │
│        │    │    ││        │  │
│        │    │    ││        │  │
│        │    │    ││        │  │
│        │    │    ││        │  │
│        │    │    ││        │  │
│        │    │    ││        │  │
├────────┴────┴────┤├────────┴─────────┤
└──────────────────┘└──────────────────┘   <инф.о текущем файле
A:>                                 <ком строка
1He 2Us 3Vi 4Ed 5Co 6Re 7Md 8Del 9Mn 0Qu   <ключи


       Выход из  DOS-SHELL  осуществляется  по  нажатию  клавиш
АР2/0 на запрос системы для выхода надо нажать "Y" ,или выбрать
ответ с помощью клавиш "←" "→" и нажать ввод.

        ┌──────────┐
        │   Quit   │▓
        │[ No] Yes │▓
        └──────────┘▓
        ▓▓▓▓▓▓▓▓▓▓▓▓

        Получение информационного сообщения осуществляется
нажатием АР2/1, при этом на диске должен присутствовать
файл Shell.hlp .

        Запуск программы DOS-Shell
        ──────────────────────────

При запуске программы на текущем диске ищется файл Shell.ini ,
создаваемый и изменяемый командой [sAve setup] в меню Commands.
При необходимости можно использовать ключи командной строки,
чтобы ускорить загрузку и перезадать настройку . Допустимы
следующие ключи (набирамые через пробел после имени программы):

/       - запретить чтение файла Shell.ini (При указании
         всех последующих ключей Shell.ini также не читается)
/M+     - разрешить работу с мышью
/M-     - запретить работу с мышью


        Выбор файлов
        ────────────
По панелям можно передвигаться с помощью  стрелок.  На  текущий
файл указывает инверсная полоса.  Имя  и  атрибуты  выделенного
инверсной полосой файла отображаются в  нижней  строке  панели.
ВВОД загружает выделенный файл и запускает его.

        Запуск программ и выполнение команд ДОС
        ───────────────────────────────────────
Набор команды осуществляется в нижней строке  экрана.  Мигающий
курсор указывает на текущую позицию. Клавиша <══ удаляет символ
справа от  курсора,  клавиша  <КТ>  очищает  командную  строку.
При нажатии АР2/ВВОД имя файла, на которое указывает  инверсная
полоса, копируется в командную строку. Клавиша ВВОД заканчивает
набор командной строки и передает ее в ДОС.  Если  в  командной
строке ничего не набрано, по <ВВОД> запустит файл,  на  который
указывает инверсная полоса.

        Использование мыши
        ──────────────────
После первого перемещения мыши на экране отображается инверсный
курсор, перемещаемый мышью по экрану. Работа с мышью  аналогич-
на работе с клавиатурой и можно совмещать и тот и другой способ
диалога. Основные правила работы с мышью :

- чтобы выбрать файл, пункт какого-либо меню или вариант ответа
  на запрос, подведите к ним курсор мыши и нажмите  левую  кла-
  вишу мыши;
- чтобы включить файл в группу, подведите к нему курсор мыши  и
  нажмите правую клавишу;
- если подвести курсор к файлу и дважды нажать  левую  клавишу,
  то это равносильно выделению файла инверсной рамкой  и  нажа-
  тию <ВВОД>;
- нажатие одновременно двух клавиш мыши отменяет текущую  функ-
  цию ( аналогично клавише <КТ> );
- если подвести курсор мыши в верхнюю  или нижнюю часть панели,
  то нажатие на клавишу мыши приведет к  прокрутке  содержимого
  панели вверх или вниз соответственно.

        Выбор в меню
        ────────────
  Выбор в меню может осуществляться тремя способами:
- с помощью стрелок подвести инверсный курсор к пункту  меню  и
  нажать клавишу <ВВОД>;
- нажать символьную клавишу, соответствующую той букве, которая
  выделена заглавной в данном пункте меню;
- подвести мышиный курсор к пункту меню и нажать левую  клавишу
  мыши.
  Клавиша <КТ> осуществляет  отказ  от  выбора  в  любом  меню.

        Управление панелями
        ───────────────────
В панели может отображаться:
- имена файлов, адрес и длина в одну колонку (режим Full);
- имена файлов в две колонки (режим Brief);
- сводная информация о диске и каталоге на другой панели(Info);
- панель не отображается (режим Off);

Для управления панелями используются клавиши:

<ТАБ>     - перейти на соседнюю панель;
СУ/U      - поменять панели местами (sWap);
СУ/P      - включить/выключить соседнюю панель;
АР2/9 L O - включить/выключить левую панель;
АР2/9 R O - включить/выключить правую панель;
<СБР>     - считать заново каталог с диска (reRead);
СУ/I      - вывести на соседней панели информацию о диске:
метка диска, общее количество блоков на диске, количество
занятых блоков и свободное пространство на диске.

Порядок вывода информации о файлах:

- алфавитный порядок имен (режим Name);
- упорядоченный в порядке убывания размера файлов (Size);
- в том порядке, как файлы записаны в каталоге (Unsorted);

        Работа с файлами
        ────────────────

DOS-SHELL позволяет выбрать группу файлов, над  которыми  можно
произвести некоторые действия: скопировать, удалить,переместить
Выбранные файлы выделяются  утолщенным  шрифтом.  Внизу  панели
появляются сведения о количестве выделенных файлов и  их  общем
размере. Выделение  отдельного  файла  осуществляется  нажатием
клавиши <ВС>. Повторное  нажатие  <ВС>  отменяет  выбор  файла.
   Выбор группы файлов по маске осуществляется  нажатием  АР2/;
и заданием маски для выбора. Использование * и ? в маске  имени
аналогично использованию этих символов в ДОС : * заменяет любое
количество любых символов, а ? заменяет один  символ  в  имени.
   Чтобы отменить выбор группы файлов по маске, нажмите АР2/- ,
и задайте маску файлов, аналогично выделению.

   С файлами возможны действия:
- Копирование АР2/5 ;
- Переименование АР2/6 . При указании вместо нового имени
  названия существующего подкаталога выбранные файлы
  переносятся в этот подкаталог. Чтобы вернуть файлы в
  корневой подкаталог необходимо вместо нового имени ввести
  символ "\".
- Удаление АР2/8. Ключ АР2/8 также может удалять пустые (!)
  подкаталоги.

Нажатие АР2/3 позволяет просмотреть выделенный инверсной рамкой
текстовый файл. Файл читается порциями, и  можно  просматривать
файлы любой длины.

        Редактирование файлов
        ─────────────────────
Для редактирования файла используется команда АР2/4.  При  этом
на экране появляется запрос:
           ┌──────────────────┐
           │ File Name :      │▓
           │[SOME_FILE       ]│▓
           └──────────────────┘▓
            ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓

  где SOME_FILE  -  имя  файла  выделенного  курсорной  рамкой.
Нажатие  клавиши  ВВОД загрузит  этот файл  для редактирования.
Если необходимо  создать  новый  файл,  то  вводится  его  имя.
Редактор Shell.ext, используемый DOS-SHELL должен находиться
на текущем диске (или на виртуальном диске БК11(М)).
Набор  команд редактирования штатного редактора:
АР2/↑ и АР2/↓ листают текст  постранично,
АР2/← и АР2/→ перемещают курсор в начало и конец  строки,  <ВС>
удаляет строку с запоминанием в буфере, <ИСУ> перемещает курсор
в начало текста, <БЛОК РЕД> перемещает курсор в  конец  текста.
СУ/F - поиск заданной строки.
<ВС> - удалить строку с запоминанием в буфере, <ПОВТ> -  выдать
строку из буфера, ═╪> удалить строку справа от курсора, <КТ>  -
выход из редактора. При нажатии <КТ> выдается запрос:
           ┌─────────────┐
           │    Save     │▓
           │ [ No ] Yes  │▓
           └─────────────┘▓
            ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓

Выбор No осуществляет  выход  без  записи  изменений  на  диск,
Yes - выход с записью файла. Для отмены запроса  и  продолжения
работы с редактором нужно повторно нажать <КТ>.
В комадной строке индицируется отношение длины текста к  макси-
мальной длине буфера текста.

Возможно использование альтернативного редактора. Для этого
необходимо переименовать его в Shell.ext. Редактор вызывается
командной строкой "Shell.ext FILENAME" и для того чтобы автома-
тически загрузился заданный файл, редактор должен обрабатывать
параметры командной строки.

        Меню DOS-SHELL
        ──────────────
Вход в меню осуществляется нажатием АР2/9 или с  помощью  мыши.
В этом режиме  доступны  пункты  меню  Left,  Right,  Commands.
Пункты Left и Right задают режимы информации и левой  и  правой
панелях соответственно. Подменю Left и Right  содержат  пункты:

 ┌──────────┐
 │[Brief   ]│▓ - режим вывода только имен файлов
 │ Full     │▓ - режим вывода имени, адреса и длины
 ├──────────┤▓
 │ Nаme     │▓ - вкл. сортировка по имени
 │ Size     │▓ - вкл. сортировка по размеру файла
 │ Unsorted │▓ - вывод файлов как в каталоге
 ├──────────┤▓
 │ On/Off   │▓ - влк/выкл данную панель
 │ Drive..  │▓ - выбор дисковода (A:,B:,...) аналогично
 └──────────┘▓   К══ для левой, │═> для правой панели
  ▓▓▓▓▓▓▓▓▓▓▓▓

Подменю Commands содержит пункты:

 ┌──────────┐
 │[Select  ]│▓ - выделить файлы (аналогично AР2/;)
 │ Unselect │▓ - отменить выделение (АР2/-)
 │ sWap     │▓ - поменять панели местами (аналогично СУ/U)
 │ Find     │▓ - поиск файла (аналогично СУ/F)
 ├──────────┤▓
 │ mOuse    │▓ - разрешить/запретить работу с мышью
 │ sAve     │▓ - запись заданных режимов на диск
 │ Info     │▓ - вывести информацию о диске
 │ cOmpare  │▓ - сравнить файлы правой и левой панелей
 └──────────┘▓
  ▓▓▓▓▓▓▓▓▓▓▓▓

 Select,Unselect,Find - возможно  использование  в  поле  имени
символов групповой обработки ? и * . При этом Select и Unselect
выделят все файлы, подходящие под указанный шаблон, а Find ука-
жет первый файл, подходящий под шаблон.
 sAve -запись текущих установок производится в файл "Shell.ini"
При последующей загрузке DOS-SHELL будет искать указанный  файл
на диске, с которого  производится  загрузка,  и  устанавливать
среду, заданную в предыдущем сеансе работы.

        Работа с командной строкой ДОС
        ──────────────────────────────
В нижней части экрана отображается приглашение и вводимые
с клавиатуры команды. Нажатие ←┘ вызывает исполнение
введенной строки. КТ - сбрасывает вводимую строку, <= - забой
введенных символов, АР2/←┘ - передает в ком. строку имя
файла, выделенное курсорной рамкой. СУ/Е - позволяет повторить
последнюю введенную команду ДОС. Просмотреть сообщения,
выдаваемые ДОС, можно удерживая нажатой любую клавишу, или
предварительно погасив одну из панелей.

        Пользовательское меню
        ─────────────────────

При нажатии АР2/2 на текущем  диске  ищется  файл  "Shell.mnu",
в котором содержится список команд, определенных пользователем.
Выбор команды осуществляется стрелками ↑↓ с  последующим  нажа-
тием <ВК>. Первые девять команд могут  быть  выбраны  цифровыми
клавишами.
        Структура файла Shell.mnu :
Файл Shell.mnu создается как текстовый файл в редакторе  SHELL.
Первая часть файла содержит строки-сообщения, выводимые в меню,
вторая - реализуемые команды. Длина строки-сообщения ограничена
и не должна превышать  24  символа.  Перед  частью,  содержащей
команды ставится разделитель '\'.

        Пример файла Shell.mnu :

ПРОСМОТР КАТАЛОГА А:
MIRAGE
ТУРБО-АССЕМБЛЕР
ЗАПУСК ДИСКОВОГО TEСTA
\
DIR A:
MIRAGE.DSK
TURBO
DTEST

        Обработка ошибок на дисках
        ──────────────────────────
При возникновении ошибки на диске DOS-SHELL выводит сообщение.
        ┌──────────────┐
        │  Disk error  │▓
        │[Retry] Abort │▓
        └──────────────┘▓
         ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓

В ответ на него надо выбрать одну из надписей Retry или  Abort.
Retry - повторить операцию ввода/вывода, при  которой  возникла
ошибка, Abort - окончить выполнение функции, при работе которой
возникла ошибка. Окончить выполнение функции можно также  нажав
клавишу <КТ>.


        Краткий перечень команд:
        ────────────────────────
←,→,↑,↓ перемещения по панелям;
←┘      запустить файл, зафиксировать выбор в меню;
АР2/←┘  скопировать имя выделенного файла в ком.строку;
СУ/Е    выдать послендюю введенную ком.строку;
КТ      отмена режимов;
ТАБ     перейти на другую панель;
ВС      включить (исключить) файл в группу;
СБР     повторно считать каталог текущего диска;
K══     выбрать диск на левой панели;
╞═>     выбрать диск на правой панели;
АР2/;   включить в группу файлы по маске;
АР2/-   исключить из группы файлы по маске;
АР2/1   краткая информация;
АР2/2   меню команд пользователя;
АР2/3   просмотр файла;
АР2/4   редактирование файла;
АР2/5   скопировать (с текущей панели на соседнюю);
АР2/6   переименовать файл;
АР2/7   создать подкаталог;
АР2/8   удалить файлы;
АР2/9   меню DOS-SHELL;
АР2/0   выход из DOS-SHELL;
СУ/F    поиск файла;
СУ/U    поменять панели местами;
СУ/P    вкл/выкл соседнюю панель;
СУ/I    вывести на соседней панели информацию о диске;


